home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / vt12b.zip / ENGLISH.DOC < prev    next >
Text File  |  1993-03-31  |  42KB  |  908 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.         ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  24.         ▒▒(█▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒(█▒▒
  25.         ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  26.         ▒▒▒▒██████▀▒▒██████████████████▀▒▒▒▒                        ▒▒▒▒
  27.         ▒▒▒▒█▒▒▒▒▒ ▒▒█▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ▒▒▒▒    VangeliSTracker     ▒▒▒▒
  28.         ▒▒▒▒▒█▒▒▒▒ ▒▒█▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ▒▒▒▒         v1.2b          ▒▒▒▒
  29.         ▒▒▒▒▒█▒▒▒▒▒ █▒▒▒▒▒    ▄▒▒▒▒     ▒▒▒▒                        ▒▒▒▒
  30.         ▒▒▒▒▒▒█▒▒▒▒▄█▒▒▒▒ ▒▒▒▒█▒▒▒▒ ▒▒▒▒▒▒▒▒ (C) 1992  VangeliSTeam ▒▒▒▒
  31.         ▒▒▒▒▒▒█▒▒▒▒▒▒▒▒▒▒ ▒▒▒▒█▒▒▒▒ ▒▒▒▒▒▒▒▒                        ▒▒▒▒
  32.         ▒▒▒▒▒▒▒█▒▒▒▒▒▒▒▒ ▒▒▒▒▒█▒▒▒▒ ▒▒▒▒▒▒▒▒ The best tracker, ever ▒▒▒▒
  33.         ▒▒▒▒▒▒▒▀         ▒▒▒▒▒▀     ▒▒▒▒▒▒▒▒                        ▒▒▒▒
  34.         ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  35.         ▒▒(█▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒(█▒▒
  36.         ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  37.  
  38.  
  39.  
  40.             What is VangeliSTeam?
  41.             ─────────────────────
  42.  
  43.             VangeliSTeam   is   a   group   of   people   participating,
  44.         continiously   or   sporadicly   in   programming,   design  and
  45.         manteniance of VangeliSTracker program.
  46.  
  47.             The reasons for us to create this group are the next ones :
  48.  
  49.             o Widely spread the methods,  formats,  routines and so,  of
  50.               making digital music, in both user and programmer level.
  51.  
  52.             o Joining  qualified people that help us in the developement
  53.               of VangeliSTracker program.
  54.  
  55.             o Learn something (Everybody). ;-)
  56.  
  57.             To  make  that  possible  the program will be distributed in
  58.         running  and  source  code,  being both of them public domain or
  59.         freeware.  However, is an express desire of VangeliSTeam to make
  60.         you  know that this piece of software is under the protection of
  61.         Copyright laws.
  62.  
  63.             Anyone  who wants it,  can make his own modifications to the
  64.         program,  use  it for his own purpouses and include the routines
  65.         in   his  own  programs  always  that  you  clearly  remark  the
  66.         procedence of them. Any of this options is considered as enough:
  67.  
  68.             o If you use  the  sources in  your own programs,  you  must
  69.               write somewhere where it  can be  seen,  something  like :
  70.               "Portions  (C)  VangeliSTeam"  or  "Using  sound system of
  71.               VangeliSTracker vX.X" or something alike.
  72.  
  73.             o If  you  include the whole VangeliSTracker in a program of
  74.               your own, you must include the whole running version.
  75.  
  76.             Anyway,  you are encouraged to inform us of any modification
  77.         made to the program or any of its routines,  in order to include
  78.         them in the next official release.
  79.  
  80.  
  81.  
  82.             Who is VangeliSTeam?
  83.             ────────────────────
  84.  
  85.             VangeliSTeam is everybody. :-)
  86.  
  87.             Well,  actually,  VangeliSTeam  is made of all those persons
  88.         participating,  in one or other way,  in programming, design and
  89.         so, of VangeliSTracker.
  90.  
  91.             Until  this release,  there is just one really active person
  92.         (Juan  Carlos  Arévalo,  that's  me  ;-),  and some other people
  93.         interested  or  working  in the program.  I am NOT going to tell
  94.         anybody what to do.  What I hope is that you tell me what do you
  95.         want to do,  and I just will try to put togeter everyone working
  96.         in the same area.
  97.  
  98.             If you want to discuss,  propose, send, receive or just talk
  99.         about VangeliSTracker or VangeliSTeam,  please,  do not hesitate
  100.         and contact one of the persons shown below:
  101.  
  102.         ╔══════════════════════════════════════════════════════════════╗
  103.         ║                        CONTACT POINTS                        ║
  104.         ╟──────────────────────────────────────────────────────────────╢
  105.         ║                                                              ║
  106.         ║Madrid (Spain):                                               ║
  107.         ║                                                              ║
  108.         ║  - Juan Carlos Arévalo                                       ║
  109.         ║        Fido:     2:341/27.16 y 2:341/9.21                    ║
  110.         ║        Internet: jarevalo@anyware.es                         ║
  111.         ║        Apdo. Correos 156405 (28080 - Madrid, Spain)          ║
  112.         ║                                                              ║
  113.         ║  - Félix Sanz                                                ║
  114.         ║        Fido:     2:341/15.27                                 ║
  115.         ║                                                              ║
  116.         ║Barcelona (Spain):                                            ║
  117.         ║                                                              ║
  118.         ║  - Luis Crespo                                               ║
  119.         ║        Fido:     2:343/108.21                                ║
  120.         ║                                                              ║
  121.         ╚══════════════════════════════════════════════════════════════╝
  122.  
  123.  
  124.  
  125.             Up to date,  VangeliSTeam is taking advantage of the work of
  126.         this other people:
  127.  
  128.         ╔══════════════════════════════════════════════════════════════╗
  129.         ║                         COLABORATORS                         ║
  130.         ╟───────────────────────────┬──────────────────────────────────╢
  131.         ║                           │                                  ║
  132.         ║  - Juan Carlos Arévalo    │ Father of the creature. Program's║
  133.         ║                           │ body and general structure.      ║
  134.         ║                           │ First releases.                  ║
  135.         ║                           │                                  ║
  136.         ║  - Luis Crespo            │ Program's predecessor (JAMP).    ║
  137.         ║                           │ DMA routines. Sound Blaster Info.║
  138.         ║                           │                                  ║
  139.         ║  - Félix Sanz             │ User DOCs.                       ║
  140.         ║                           │                                  ║
  141.         ║  - Alejandro López        │ Original stereo channel mixing   ║
  142.         ║                           │ idea.                            ║
  143.         ║                           │                                  ║
  144.         ║  - Héctor Martínez        │ FFT routines. (not implemented   ║
  145.         ║                           │ yet).                            ║
  146.         ║                           │ Original four channel handling   ║
  147.         ║                           │ system idea.                     ║
  148.         ║                           │                                  ║
  149.         ║  - David López            │ SB-Pro stereo information.       ║
  150.         ║                           │                                  ║
  151.         ║  - Angel Trigo            │ SB-Pro stereo information.       ║
  152.         ║                           │                                  ║
  153.         ║  - José Ruiz              │ Now working on OS/2 version      ║
  154.         ║                           │ (True OS/2 ;-)                   ║
  155.         ║                           │                                  ║
  156.         ║  - Manuel Petit           │ Now fitting a mouse driver.      ║
  157.         ║                           │                                  ║
  158.         ║  - Carlos Fernández       │ Made a modification in the       ║
  159.         ║                           │ swapping system, to make it work ║
  160.         ║                           │ on CD-ROMS.                      ║
  161.         ║                           │                                  ║
  162.         ║  - Néstor Matas           │ Translation of this manual into  ║
  163.         ║                           │ English.                         ║
  164.         ║                           │                                  ║
  165.         ╚═══════════════════════════╧══════════════════════════════════╝
  166.  
  167.             Thanks  goes to Carlos Jiménez for owning a SB Pro 2.0,  and
  168.         lending it for some experiments (just testing... :-).
  169.  
  170.             Thanks  goes to Javier Olmo,  for being the owner of a SB 16
  171.         and lending it for testing.
  172.  
  173.             Thanks  goes to Michael Fulbright,  for adapting a SB driver
  174.         for OS/2, and for making it accesible from a DOS session.
  175.  
  176.             Thanks  goes  to Steve Haehnichen for making a SB driver for
  177.         UNIX BSD, in which Michael Fulbright based his own driver.
  178.  
  179.             Thanks  goes  to  Francisco Carrascosa for being so tiresome
  180.         (wish everybody was that way ;-D
  181.  
  182.  
  183.  
  184.             Thanks  goes  to  Antonio  Ropero,  for owning a Covox Sound
  185.         Master  II,  and  stoically stand not having the DMA driver.  In
  186.         the next release I promise, I swear that ...  O;-)
  187.  
  188.             Thanks also to the Future Crew people,  for making such good
  189.         music and demos.
  190.  
  191.             Likewise,  we wish to thank all those people that, in one or
  192.         other way, had contributed to this.
  193.  
  194.             Thank you:
  195.  
  196.             Javier Arévalo,  Mario Elkati, Avelino Martín, Víctor Neira,
  197.         Francisco  Sedano,  David López II ;-),  Carlos Melero,  Patrick
  198.         Dobeson,  Santiago  Crespo,  Juanantón  Roque,  Tomás Fernández,
  199.  
  200.             Also thanks to the whole staff of Anyware S.A.  for standing
  201.         the  testing  made  in  their  computers,  and thanks to all the
  202.         people I forgot to mention in the list. :-(
  203.  
  204.  
  205.             System requierements.
  206.             ─────────────────────
  207.  
  208.             o PC computer or compatible, with 286 processor or higher.
  209.             o When using OS/2, Michael Fulbright driver requiered.
  210.             o VGA or EGA graphics card.
  211.             o Around  230 Kb free RAM + module lenght.  Around 140 Kb in
  212.               case you use ShellVT.
  213.             o An EMS driver, in case of using swapping.
  214.             o 1 or 2 paralell ports, when using DAC.
  215.             o One of this cards, if requiered by the user:
  216.                o Covox Sound Master II card, Intersound MDO or similar.
  217.                o Any version of SoundBlaster card.
  218.                o AdLib sound card or compatible.
  219.  
  220.             To  make  it work,  you will need some music files in one of
  221.         .MOD, .WOW, .OKT, .STM, .S3M or .669 formats.
  222.  
  223.             Connect your device to the computer !!!!!! :-)
  224.  
  225.             ...yes, but, what is the DAC?
  226.  
  227.             A  DAC  (Digital  to  Analog  Converter),  is a built of DAC
  228.         chips  or  resistors  that,  connected to the parallel port,  is
  229.         able to playback digital sounds through an amplifier.  Later on,
  230.         under the title of  "How to build a homemade DAC", you will find
  231.         a  diagram  and  some  directions  on  building  one.  The sound
  232.         quality  provided  by  one  of  this  gadgets is similar to that
  233.         found  in  any  commercial cards,  but avoiding the peculiar bus
  234.         noise of Sound Blaster or Covox SM II cards (so it's better).
  235.  
  236.  
  237.             Actual program features.
  238.             ────────────────────────
  239.  
  240.             Up  to date (see the date at the end ;-),  the program seems
  241.         to have this features:
  242.  
  243.  
  244.               MODULES
  245.  
  246.             o Is  able  to  play  modules  in  Amiga's  SoundTracker and
  247.               NoiseTracker (and compatibles)  programs format (.MOD). It
  248.               handles  15  and 31 voices modules with both marks  "M.K."
  249.               and  "FLT4".  It can play also, .WOW format modules (Grave
  250.               Program),   6  and  8  channel   .MOD  (from  Triton  Fast
  251.               Tracker),  .OKT  (Amiga's Oktalizer),  Scream Tracker 2.x,
  252.               Scream  Tracker  3.0 and Composer 669 (PC).  It still does
  253.               not handle JMPlayer,  670, Amiga's Oktamed nor StarTrekker
  254.               formats.
  255.  
  256.             o It  implements  a  subset of Amiga's Prototracker program,
  257.               musical capabilities,  which allows almost every module to
  258.               be  played  in  an  adequate  way  (All the modules tested
  259.               did).  If  you  find  any  module  that can't be played or
  260.               sounds  bad,  contact  us (sending the module,  of course)
  261.               and we will do whatever is posible to fix the problem.
  262.  
  263.  
  264.               SOUND DEVICES
  265.  
  266.             o Is able to play modules in various sound devices :
  267.                o PC Speaker (Ouch! Not widely recomended :-).
  268.                o Any  availabe  DAC in the I/O port map (including cards
  269.                  like Covox,  Intersound-MDO,  homemade DACs in paralell
  270.                  port, and so).
  271.                o Sound  Blaster  or  compatible  and AdLib or compatible
  272.                  (not always).
  273.                o Visha speech card.
  274.                o Apart,  for  woking  under  OS/2,  Michael  Fulbright's
  275.                  driver can be used.
  276.  
  277.             o For stereo sound,  it allows the use of Sound Blaster Pro,
  278.               Sound   Blaster   16   ASP,   two  DACs  or  one  DAC  and
  279.               SoundBlaster  in  mono  mode.   Also,  it  implements  two
  280.               different  ways of channel mixinf that enhances the stereo
  281.               sound quality, especially when using headphones.
  282.  
  283.             o To  play  sounds  in  Sound  Blaster  card  there  are two
  284.               methods: using DMA or not using DMA.
  285.  
  286.             o Also  implements  several  kinds  of software-made digital
  287.               filters.
  288.  
  289.  
  290.               THE SCREEN
  291.  
  292.             o To  use  VangeliSTracker you will need a VGA or compatible
  293.               video card.  It works with EGA too, but it won't in future
  294.               versions.
  295.  
  296.             o The  windows  contain: Module information,  real time four
  297.               channel  description,  sample  list,  oscilloscope,  menu,
  298.               track (music sheet, two sizes) and credits.
  299.  
  300.  
  301.  
  302.               WORKING
  303.  
  304.             o The  program  does  not works in interactive mode...  yet.
  305.               That  means  that  you  can use it just as you would use a
  306.               DOS line command.
  307.  
  308.             o The  program  can perform some actions while playing music
  309.               :  Shell  to  DOS  (  the  music will continue playing  ),
  310.               activate  or  desactivate any of the sound channels,  fast
  311.               forward  and  rewind  the song,  change the sampling rate,
  312.               rise or lower the music volume or change the filters.
  313.  
  314.             o In  the  config  file  you can define a program to execute
  315.               instead of COMMAND.COM when shelling.
  316.  
  317.             o If   you   rise   the   sampling  rate  over  the  program
  318.               capabilities,  it  will  automatically reduce it downto an
  319.               adequate level (fall-back).
  320.  
  321.             o When jumping from one song to the next,  a fade-out option
  322.               is available.
  323.  
  324.             o The  program  uses  EMS  swapping (if available)  and disk
  325.               swapping.
  326.  
  327.             o The  program will use the free UMB area,  if any,  if it's
  328.               MS-DOS 5.0 compatible.
  329.  
  330.  
  331.             Undesirable, known features.
  332.             ─────────────────────────────
  333.  
  334.             As  everybody  knows,  no  one  (and  nothing)  is  perfect.
  335.         VangeliSTracker  is not an exception to the rule and so,  it has
  336.         some  known  and  unknown  bugs.  Here  is a relation of all the
  337.         known bugs.  If you find any other,  have no doubt about telling
  338.         us, in order to attach it to the list or simply fix it.
  339.          ;-)
  340.  
  341.             o Sometimes,  you  may find DOS Shell problems.  A matter of
  342.               stack.  The  stack use has been reduced down to 150 bytes,
  343.               but  it could give problems when forcing the sampling rate
  344.               over the machine capabilities.
  345.  
  346.             o Sometimes,  the  program  does  not  work  when local area
  347.               network drivers are present (Ethernet or similar).
  348.  
  349.             o If  you have any memory handler loaded in memory that uses
  350.               386 virtual mode (like QEMM386,  EMM386,  386Max,  and so)
  351.               the program will slow down.  If you don't use DMA, it will
  352.               work  properly  but  it  won't be able to handle very high
  353.               sampling  rates.  If  you  use  DMA  in a non fast machine
  354.               (386-25Mhz  is  a  non fast machine),  and you are using a
  355.               sound  card  different  from  SB  16,   the  program  will
  356.               reverberate  a  little  bit  (not  much: the music will be
  357.               heard all right,  but it can be kind of annoying with some
  358.               .MODs, especially if they contain high pitch instruments).
  359.  
  360.             o When using multitaskers (OS/2 2.0,  Windows, Desqview, and
  361.               so)  the  program  may work (not always),  but just in DMA
  362.               mode  and gargling a lot (a strong reberveration).  In all
  363.               of them,  the "File" driver always work, dumping the sound
  364.               output to the file SBDSP$.
  365.  
  366.  
  367.  
  368.             o When  Shelling to DOS,  the program will use an ammount of
  369.               RAM of 230 Kb plus the module lenght.  To save memory, use
  370.               ShellVT.
  371.  
  372.             o The  automatic fall-back,  sometimes,  goes over or do not
  373.               reach  the  desired  value.  Is  very difficult to get the
  374.               machine to do this accurately. :-(
  375.  
  376.             o The  program  recognizes  modules  with instruments bigger
  377.               than 64 Kb, but it will truncate them to 64 Kb.
  378.  
  379.             o The  Adlib  driver  sounds  at a very low volume,  and too
  380.               noisy.  In  some  sound  cards  you  will  notice a strong
  381.               wishtling,  but  is  not  the  case  of  Sound Blaster nor
  382.               AdLib. :-)
  383.  
  384.             o If  you  use the OS/2 driver (File),  what you will get on
  385.               the  screen  will  have  nothing to do with what you hear.
  386.               Lack  of  sincronism...  The  keyboard won't work properly
  387.               either.  In  this  case,  we  recommend  you  the  use  of
  388.               OS2VT.EXE .
  389.  
  390.             o The memory swapping is not widely tested yet.
  391.  
  392.  
  393.             Future features in the program.
  394.             ───────────────────────────────
  395.  
  396.             VangeliSTracker  is  a  beginner.  By  now it just works and
  397.         nothing  else  but  we pretend to make it grow to reaching goals
  398.         like:
  399.  
  400.             o Support   for   more   module   formats   (670,   Oktamed,
  401.               StarTrekker and so).
  402.  
  403.             o Support  for  other  sound  devices  (SBPro 3.0 in 16 bits
  404.               mode,  Pro Audio Spectrum,  Disney SS,  Covox in DMA mode,
  405.               and  so).  If  someone  make  the driver or lend us one of
  406.               this cards, we will be ethernally grateful.
  407.  
  408.             o Increase  the  program posibilities with: song edition and
  409.               composition,  digital  sound  and  instrument  edition and
  410.               processing,  MIDI  support,  as  well as everything we can
  411.               machinate.
  412.  
  413.             Remember:  all  of  this  won't  be  possible  without  your
  414.         colaboration.  We  need ideas,  beta-testers,  critcs and labour
  415.         ;-).
  416.  
  417.  
  418.  
  419.             Next release. (2.X)
  420.             ───────────────────
  421.  
  422.             In next version 2.0a of VT we hope to implement :
  423.  
  424.             o Simple   interactive   mode  (choose  a  module  within  a
  425.               menu...).
  426.  
  427.             o More  windows:  10  oscilloscopes (one per channel),  real
  428.               volume bars,  Spectrum analizer,  instrument analizer, DOS
  429.               shell in a window (yeah,  yeah, ain't no joke. If you want
  430.               to see how it will look like, press F9).
  431.  
  432.             o Mouse support.
  433.  
  434.  
  435.             Command line options.
  436.             ─────────────────────
  437.  
  438.             VT  sintax  can  be  seen  by  running  the  program without
  439.         parameters.  You can save it in a file,  rerouting the output if
  440.         you want: 'VT > VTOPT.TXT'.
  441.  
  442.             The syntax of ShellVT and OS2VT is exactly the same.
  443.  
  444.  
  445.             Option switch files (.VTO)
  446.             ──────────────────────────
  447.  
  448.             You  can  specify parameters in ASCII files,  using the same
  449.         syntax as in the command line.  They are used preceding the file
  450.         name with an at-sign (@). For example:
  451.  
  452.             VT @UNREAL.VTO
  453.  
  454.             For  more  information,  look  into  the example  .VTO files
  455.         included.
  456.  
  457.  
  458.             Config file.
  459.             ────────────
  460.  
  461.             VT  has  a  configuration  file,  called  VT.CFG.  This file
  462.         contains  some options that modifies the internal working of the
  463.         program.  The  file  is  ASCII,  so  it can be modified with any
  464.         editor  o  word  processing  software.  If  you want to know the
  465.         available options,  please feel free to examine it, and read the
  466.         comments inside it.
  467.  
  468.             By  default,  the config file will be loaded from the VT.EXE
  469.         directory  but  if the search fails,  VT will look for it in the
  470.         current directory.
  471.  
  472.             SHELLVT.EXE   program   will  read  VT.CFG  file  and  then,
  473.         SHELLVT.CFG, where you can redefine every single parameter.
  474.  
  475.  
  476.  
  477.             Interface. VT Screen.
  478.             ─────────────────────
  479.  
  480.             The screen is in text mode, and presents this aspect:
  481.  
  482.         ╔═══════════════╤════════════════════════════════╤═════════════╗
  483.         ║Posición: 1/ 44│Módulo:    beethoven 7th remx   │             ║
  484.         ║Patrón:   1/ 24│Fichero:   BEETHOVE.MOD         │  VSTracker  ║
  485.         ║Nota:     1/ 64│Mem. libre:  0 (0) | 278944     │     X.Yz    ║
  486.         ║Tempo:    6 F30│Frecuencia:16000 Volumen:127    │             ║
  487.         ╟───────────────┴───┐freq─vl─reps─repl─len─┬─────┴─────────┬───╢
  488.         ║1                  │                      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│   ║
  489.         ║2        (1)       │                      │▒▒▒▒▒▒(2)▒▒▒▒▒▒│(7)║
  490.         ║3                  │                      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│   ║
  491.         ╟───────────────────┼─────────────────┬────┴───────────────┴───╢
  492.         ║ 2 st-02:tallic    │17               │ FILE  EDIT  PLAY  MISC ║
  493.         ║ 4 st-02:reflex    │19               │ SAMPLES  PATTERN  SONG ║
  494.         ║ 6 st-01:bassdrum2 │21               ├────────────────────────╢
  495.         ║ 7 st-02:mysnare1  │22               │ PAr/Ab Otro patrón     ║
  496.         ║ 8 st-01:hihat2    │23               │ In/Fin Idem (principio)║
  497.         ║ 9 st-01:popsnare1 │24               │ 1-0    Apagar canal    ║
  498.         ║10 st-01:strings3  │25               │ F5-F9  Ventanas        ║
  499.         ║11 st-01:organ     │26               │ R/T    Frec. de salida ║
  500.         ║12                 │27               │ +/-    Volumen         ║
  501.         ║13                 │28               │ D      Shell al DOS    ║
  502.         ║14      (3)        │29      (3)      │ N/S    Sig. canción    ║
  503.         ║15                 │30               │ ESC    Parar           ║
  504.         ╟──┬──<Canal 1>───┬─┴<Canal 2>───┬──<Canal 3>───┬──<Canal 4>───╢
  505.         ║  │              │              │              │              ║
  506.         ║  │     (4)      │     (4)      │     (4)      │      (4)     ║
  507.         ║  │              │              │              │              ║
  508.         ╟──┼──────────────┼──────────────┼──────────────┼──────────────╢
  509.         ║  │     (5)      │     (5)      │     (5)      │      (5)     ║
  510.         ╟──┼──────────────┼──────────────┼──────────────┼──────────────╢
  511.         ║ 1│ G 3 01 ····· │ G 2 01 ····· │ ············ │ G 1 02 ····· ║
  512.         ║ 3│ ············ │ ············ │ ············ │ ············ ║
  513.         ║ 4│ ····(6)····· │ ····(6)····· │ ····(6)····· │ ·····(6)···· ║
  514.         ╚══╧══════════════╧══════════════╧══════════════╧══════════════╝
  515.  
  516.             Where each part is:
  517.  
  518.             o Position  :  Is  the  actual position within the song.  It
  519.               also shows the total lenght of the module.
  520.  
  521.             o Pattern  :  Shows the pattern currently being played,  and
  522.               the total number of them.  Normally there is less patterns
  523.               than positions in a module,  that is possible becouse some
  524.               of them are repeated.
  525.  
  526.  
  527.  
  528.             o Note  :  Shows  the  note  currently  being  played,   the
  529.               ordinal number is refered to the actual pattern.  Also, it
  530.               shows the size of the pattern.
  531.  
  532.             o Tempo  :  Is  the  actual tempo of the melody,  but it can
  533.               change if the author used the appropiate command.
  534.  
  535.             o Module :  Is the song loaded and playing,  shows the title
  536.               or name that the author gave to the theme.
  537.  
  538.             o File  :  Is the file name containig the song.
  539.  
  540.             o Free  mem.  :  Internal  values,  shown  just for debuggin
  541.               reasons.
  542.  
  543.             o Outp. freq.  :  Shows the music output rate, in Hertzs.
  544.  
  545.             o (1)  :  This  area shows the instrument being used by each
  546.               one  of  the  four visible channels.  At left hand you can
  547.               see the channel number.
  548.  
  549.             o frec  :  Shows  the  pitch  of  each  note being played by
  550.               each visible channel.
  551.  
  552.             o vl  :  Is   the   playback   volume   of  this  particular
  553.               instrument.
  554.  
  555.             o len  :  Is   the   lenght   in   bytes  of  the  digitized
  556.               instrument.
  557.  
  558.             o (2)  :  This  area  shows  the  volume  vumeters  for each
  559.               visible channel.
  560.  
  561.             o (7)  :  Channel    Status   zone.    It   shows   if   the
  562.               corresponding channel is ON or OFF.
  563.  
  564.             o (3)  :  Module  instrument  list.  Name  and number.  This
  565.               part  of  the  screen  will  be  overlayed  when selecting
  566.               oscilloscope window.
  567.  
  568.             o (4)  :  Shows  the  notes  that  have just being played in
  569.               the pattern para the visible channels.
  570.  
  571.             o (5)  :  Shows  the  note  being  currently  played for the
  572.               visible channels.
  573.  
  574.             o (6)  :  Shows  the  notes to be played next in the pattern
  575.               for the visible channels.
  576.  
  577.  
  578.  
  579.             The keyboard.
  580.             ─────────────
  581.  
  582.             This  is  a  relation  of  the  keys you may use and a brief
  583.         description of them.
  584.  
  585.             o Page  Up and Page Down  :  It moves to the preceding or to
  586.               the  next  pattern  in the module,  but positioning in the
  587.               same note number,  not at the beginning of the pattern, as
  588.               other programs do.
  589.  
  590.             o Home and End  :  Like PgUp & PgDn,  but positioning at the
  591.               beginning of the pattern.
  592.  
  593.             o Left  and  Right arrows  :  Left or right scrolling of the
  594.               visible  channels.  This has been made this way to be able
  595.               to  see  up  to  10  channels  respecting  the  old screen
  596.               format, made to handle just 4 voices.
  597.  
  598.             o 1  -  0  :  Activates  or  desactivates  the corresponding
  599.               channel ('0' means 10).
  600.  
  601.             o F5  :  Shows  the  track in large size.  You will only see
  602.               the  track  and  the  four  or  five  first  lines  of the
  603.               original screen.
  604.  
  605.             o F6  :  Returns to regular size track mode.
  606.  
  607.             o F7  :  Oscilloscope,   show   a   graphic  of  the  analog
  608.               waveform  currently  being  played.  It ovelays instrument
  609.               list in zone (3).
  610.  
  611.             o F8  :  Credits.  Shows  the  list  of the people that have
  612.               took part in the creation of the program.
  613.  
  614.             o R  and T  :  Lower or rises the output rate of the module.
  615.               When  using  PC  speaker  device,  at  low  rates you will
  616.               notice  some  distortion.  If  you  use Sound Blaster with
  617.               DMA,  the rate will be limited internally by the card,  so
  618.               if  you  try  to go over the limit,  the program won't let
  619.               you do that.
  620.  
  621.             o F  and  G  :  Activates,  desactivates the filter.  ON and
  622.               OFF .
  623.  
  624.             o L  :  Switches  the  bass enhancing filter.  Only works in
  625.               mono devices, and not with the "File" device.
  626.  
  627.             o W and E  :  Increases and decreases the song's tempo.
  628.  
  629.             o + and -  :  Main volume control.
  630.  
  631.             o B  :  Changes the vu-meter aspect.
  632.  
  633.             o D  :  DOS  Shell.  To return to VT,  enter EXIT at the DOS
  634.               prompt.
  635.  
  636.             o N  :  Jumps  to  next  module if any.  Fades-out,  if this
  637.               feature is enabled in the config file.
  638.  
  639.             o S  :  Fast jump to next module.
  640.  
  641.             o ESC  :  Stops  playing  the  module  and quit the program,
  642.               returning to the operating system.
  643.  
  644.  
  645.  
  646.             General Remarks.
  647.             ────────────────
  648.  
  649.             If  you  try  to play a non valid format file,  VT will just
  650.         flash and skip it.
  651.  
  652.             When  shelling  from VT,  no jump to the next module will be
  653.         made until exiting the shell and returning to the program.
  654.  
  655.  
  656.             Sound Blaster.
  657.             ──────────────
  658.  
  659.             The   way  Sound  Blaster  card  works  deserves  a  special
  660.         mention.  There are two methods of playing modules through Sound
  661.         Blaster  card.  One  is  the  way used by programs like ModPlay,
  662.         Whacker Tracker or JAMP.  This method consist of sending between
  663.         6000  and  44000  samples (numbers)  per second to the card Hand
  664.         made!!.  The  other  uses  SB  DMA  support.  The former has the
  665.         advantage of reaching as-high-as-we-want sampling rates,  higher
  666.         than  those  allowed  by  Sound  Blaster  1.5  DMA.  The latter,
  667.         instead,  allow  us  to play modules in slow machines (286 a 8 o
  668.         12  MHz),  and  run the program under multitaskers like Desqview
  669.         or  Windows  (although,  by  now,  it  does not sound well under
  670.         multitasker programs, only under OS/2 using the driver).
  671.  
  672.             What  is  really  special  about  VT  is the handling of the
  673.         first  method:  not using DMA.  It shouldn't be a real problem :
  674.         In  fact,  that  is  the  only  way  to  make the PC speaker say
  675.         something  :-(  or  to  get the DAC working.  But the problem is
  676.         that Sound Blaster wasn't build to work this way and,  so, it is
  677.         harder  to  find the way,  and when you finally get something it
  678.         goes turtle step (and does not allow very hihg sampling rates).
  679.  
  680.             VT  uses  a  special  method to speed up the card under this
  681.         mode.  To  make  it possible,  we use the variable SbSplTimeout.
  682.         Give different values to it till you find the right one.  A very
  683.         high value,  (like 50,  for example) make the SB to work like it
  684.         would do with any other program (slowly).  A very low value, (1,
  685.         for  example)  speeds up SB card,  but you may not hear anything
  686.         :-(.  Let's give an example, in a 386-25 non cache computer, and
  687.         using  SB  2.0,  the  right  value  will  be  between  3  and 4,
  688.         depending on which SB mode you are using: mono or DAC-SB stereo.
  689.  
  690.  
  691.  
  692.             How to build a homemade DAC.
  693.             ────────────────────────────
  694.  
  695.             You'll need:
  696.  
  697.             o A D-25 pin male connector.
  698.             o Nine wire cable.
  699.             o A base for the circuit. A bakelite plaque, a cardboard ...
  700.             o 9 10K resistors, 1% tollerance.
  701.             o 9 20K resistors, 1% tollerance.
  702.             o One 100nF ceramic capacitor.
  703.             o One 10nF ceramic capacitor.
  704.             o One shielded cable.
  705.             o One  RCA  or  normal jack,  depending on the amplifier you
  706.               use.
  707.  
  708.             The resistors must be 1% tollerance,  to avoid noise. If you
  709.         can't find 10K and 20K,  buy similar values, but one must be two
  710.         times the other.
  711.  
  712.             The  capacitors may not be nedeed,  but it will sound better
  713.         with them.
  714.  
  715.         ┌───────────────────────────────────────────────────────────────┐
  716.         │                                                               │
  717.         │   LPT (D-25):                                                 │
  718.         │                                                               │
  719.         │   signal pin                                                  │
  720.         │                  20k   20k                                    │
  721.         │   D0     2   >───░░░─┬─░░░──────> 0v (GND, pin 20)            │
  722.         │                  20k ░ 10k                                    │
  723.         │   D1     3   >───░░░─┤                                        │
  724.         │                  20k ░ 10k                                    │
  725.         │   D2     4   >───░░░─┤                                        │
  726.         │                  20k ░ 10k                                    │
  727.         │   D3     5   >───░░░─┤                                        │
  728.         │                  20k ░ 10k                                    │
  729.         │   D4     6   >───░░░─┤                                        │
  730.         │                  20k ░ 10k                                    │
  731.         │   D5     7   >───░░░─┤                                        │
  732.         │                  20k ░ 10k                                    │
  733.         │   D6     8   >───░░░─┤                                        │
  734.         │                  20k ░ 10k                                    │
  735.         │   D7     9   >───░░░─┤                                        │
  736.         │                  20k ░ 10k      100nF                         │
  737.         │                      ├─────>  >──┤├─┬──>                      │
  738.         │                      │              │                         │
  739.         │                      ░ 10k      10nF┴   ──> Amplif.           │
  740.         │                      │              ┬                         │
  741.         │   GND    20  >───────┴─────>  >─────┴──>                      │
  742.         │                                                               │
  743.         └───────────────────────────────────────────────────────────────┘
  744.  
  745.             This  circuit,  extracted  from Visual Player 1.1 documents,
  746.         is an enhancement of that contained in Mark J.Cox's ModPlay,  so
  747.         we  thank  Mark  J.Cox  for  his original design and also to the
  748.         Visual  Player  team  for  the enhancement and the permission to
  749.         use it.
  750.  
  751.  
  752.  
  753.             Working under OS/2.
  754.             ───────────────────
  755.  
  756.             VT.EXE  program  (using  File device)  and OS2VT.EXE program
  757.         work  under  OS/2  through the Sound Blaster driver contained in
  758.         SBOS2V09.*. This file can be found at the BBSs stated below.
  759.  
  760.             The  file  includes  the  driver souce code,  and some other
  761.         playing and recording utilities under OS/2, and a MOD player.
  762.  
  763.  
  764.             ShellVT Program.
  765.             ────────────────
  766.  
  767.             Along  with  VT.EXE and OS2VT.EXE,  you'll find SHELLVT.EXE.
  768.         It's a VT version whose graphic interface has been removed,  but
  769.         working  exactly the same as if you run VT.EXE and the you press
  770.         'D'  key.  The  main  advantage of this program is that it works
  771.         like   a   background   job   under   DOS,   with  lower  memory
  772.         requierements than VT.EXE.
  773.  
  774.  
  775.             New releases.
  776.             ─────────────
  777.  
  778.             You  can  find  find  any  new version in many Spanish BBSs,
  779.         but, firstly in:
  780.  
  781.             NADA de NADA        Fidonet: 2:341/27
  782.                                 Tlf: 34-1-6969121   9600
  783.                                 24h
  784.  
  785.             SERVOSIS            Fidonet: 2:341/9
  786.                                 Tlf: 34-1-6916411   16800
  787.                                 24h
  788.  
  789.             Enchufe             Fidonet: 2:341/24
  790.                                 Tlf: 34-1-5477210   14400
  791.                                 22:00 - 07:00   (CET)
  792.  
  793.             Programmer's Land   Fidonet: 2:341/20
  794.                                 Tlf: 34-1-3065142   14400
  795.                                 22:00 - 07:00    (CET)
  796.  
  797.  
  798.             The file names used will be the following:
  799.  
  800.             Exe files   :     VTEXExxx.*
  801.             Source files:     VTSRCxxx.*
  802.  
  803.             where  "xxx" stands for the version number. For example, the
  804.         exe files of 1.2b version will be named as : VTEXE12B.*
  805.  
  806.  
  807.  
  808.             The Media Vision Contest.
  809.             ─────────────────────────
  810.  
  811.             In   the   March  number  of  the  Dr.   Dobbs  Journal  for
  812.         Programmers,  there  is quite an interesting article about sound
  813.         for  the  PCs.  I  won't  copy  the  article here (that would be
  814.         illegal),  but  I  can tell you about a little gray box where it
  815.         says  that  Media  Vision (those who make the Pro Audio Spectrum
  816.         cards)  are  organizing  a  sound  software  contest.  It  looks
  817.         interesting.  The  limit  date for the programs is 15th of July,
  818.         so there's plenty of time.
  819.  
  820.             There are two drawbacks:
  821.  
  822.             o A  must  for  any  program  that  participates  is  16 bit
  823.               support using the PAS 16 card.  For this, a driver must be
  824.               made, tested, etc...
  825.             o The  contest runs through Compuserve.  I don't know how it
  826.               works.  The  only  thing  I know (I've been told)  is that
  827.               it's  expensive.  The Media Vision guys say they've made a
  828.               special conferencefor the contest  "GO PAS16CONTEST",  and
  829.               that there's the "Entry Kit".
  830.  
  831.             I  officially  ask  for  help to anyone who can give it some
  832.         way  or  the  other.  Wether  it's  your knowledge of the PAS 16
  833.         card,  or he just wants to help, or has access to Compuserve, or
  834.         wants to beautify the program for the date.
  835.  
  836.             Sincerely,  I  think  there  are  possibilities of getting a
  837.         prize, even if only one of the 50 finalists.
  838.  
  839.             The prizes are: $5000,  $2000 and $1000 for the first three,
  840.         and $100 for the 50 finalists. All of them in "shopping sprees".
  841.  
  842.             I  don't know how we could split the prize.  I wouldn't want
  843.         anybody  to  regret anything afterwards.  If you've got any idea
  844.         about this, please, say so.
  845.  
  846.  
  847.  
  848.             Donations.
  849.             ──────────
  850.  
  851.             At first,  I was not going to mention this matter, but after
  852.         a few conversations with my colleages, I decided to do it.
  853.  
  854.             This  program  has  been  donated  to  public  domain by the
  855.         reasons  explained  at  the  beginning of this DOC.  As a public
  856.         domain  program,  you  are not requiered to pay any registration
  857.         fee. I think this point is clear enough.
  858.  
  859.             But if,  for any reason,  you like so much this program that
  860.         you  can't  help  yourself giving a donation (money or hardware)
  861.         to  those who made this possible,  well,  you are free to do it.
  862.         You can send any donations to:
  863.  
  864.         ┌──────────────────────────┐
  865.         │ Juan Carlos Arévalo      │
  866.         │ Apdo. de Correos 156.405 │
  867.         │ 28080 - Madrid           │
  868.         │ Spain                    │
  869.         └──────────────────────────┘
  870.  
  871.             Anyway,  we  will  try to use any donation in developing VT.
  872.         We  will  also  mention  in  this DOC any card donation,  driver
  873.         donation or useful information,  that may help us to enhance the
  874.         program.
  875.  
  876.             If  someone  can't  find  the  source code and would like to
  877.         take  a  look at them,  send us a self adressed,  already posted
  878.         (or  send the stamps or the money)  envelope and one diskette (3
  879.         1/2 if possible).
  880.  
  881.  
  882.             Final remarks.
  883.             ──────────────
  884.  
  885.             We  can  seem to be a bit tiresome,  but,  please,  remember
  886.         this important points:
  887.  
  888.             o We  do  NOT  want  any  money.  Just  the  credit  our job
  889.               deserves.
  890.  
  891.             o Is a very cheap price, a real bargain. Please pay it. ;-)
  892.  
  893.             o Please,  spread this program everywhere.  We want it to be
  894.               known  all  along  the  five (I got it right this time ;-)
  895.               continents.
  896.  
  897.             o If  you  want,  can  or  would  like to participate in the
  898.               project,  have  no  doubt  about telling us.  Don't forget
  899.               that the sources are given to public domain too.
  900.  
  901.             Thank you everybody for your colaboration. :·)
  902.  
  903.             Greets, and enjoy it!
  904.  
  905.                                          VangeliSTeam
  906.                                      March the 31st, 1993
  907.  
  908.